From 40b28ac66a5b11eb98d6bf72db65a1b602ca1a60 Mon Sep 17 00:00:00 2001 From: Carlos Garnacho Date: Mon, 18 Jan 2016 22:22:24 +0100 Subject: [PATCH] gdk: Document the functions that don't need calling on managed DnD These functions will be automatically called by the windowing backend. The usual hooks to run this from in gtk/ shouldn't even happen, but it is worth to document which calls are expected and which aren't. --- gdk/gdkdnd.c | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/gdk/gdkdnd.c b/gdk/gdkdnd.c index e324c18faa..b34b824b9b 100644 --- a/gdk/gdkdnd.c +++ b/gdk/gdkdnd.c @@ -428,6 +428,9 @@ gdk_drag_status (GdkDragContext *context, * * This function is called by the drag source. * + * This function does not need to be called in managed drag and drop + * operations. See gdk_drag_context_manage_dnd() for more information. + * * Returns: */ gboolean @@ -461,6 +464,9 @@ gdk_drag_motion (GdkDragContext *context, * Aborts a drag without dropping. * * This function is called by the drag source. + * + * This function does not need to be called in managed drag and drop + * operations. See gdk_drag_context_manage_dnd() for more information. */ void gdk_drag_abort (GdkDragContext *context, @@ -479,6 +485,9 @@ gdk_drag_abort (GdkDragContext *context, * Drops on the current destination. * * This function is called by the drag source. + * + * This function does not need to be called in managed drag and drop + * operations. See gdk_drag_context_manage_dnd() for more information. */ void gdk_drag_drop (GdkDragContext *context, -- 2.30.2